home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 019a / hexd141.zip / HEXD.DOC < prev    next >
Text File  |  1991-12-07  |  24KB  |  453 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                     Hex Dump  Version 1.41
  10.                     
  11.                     Copyright 1987-1991 
  12.                     Mike Fleischmann
  13.                     All rights reserved.
  14.                     
  15.                     
  16.                     Mike Fleischmann
  17.                     2828 W. Lake St.
  18.                     Ft. Collins, CO 80521
  19.  
  20.  
  21.     Welcome to Hex Dump. This is a hexadecimal file dump program with 
  22.     the following features.
  23.     
  24.         o   Handles files up to 2.5 billion bytes.
  25.         
  26.         o   Configurable record sizes from 16 bytes to 32k bytes.
  27.         
  28.         o   Full searching available.
  29.         
  30.         o   Can load and use up to 5 translation tables on either the 
  31.             hex or ASCII side of the display.
  32.         
  33.         o   Block size can be changed from within the program
  34.         
  35.         o   Help screen and status screens available.
  36.         
  37.         o   Options always displayed on the bottom of the screen
  38.         
  39.         o   Full printing of the data is supported by either blocks or 
  40.             addresses.
  41.         
  42.         o   User selectable screen colors.
  43.         
  44.         o   Can move relative to the current position in the file.
  45.             
  46.         o   Relative goto's now supported.
  47.  
  48.     For those of you who want to get started quickly, just type HEXD 
  49.     and the file you wish to view. Once in HEXD press F1 for function 
  50.     key list. Feel free to play as this is a read only utility and 
  51.     WILL NOT write to the file you are viewing.
  52.     
  53.     To register just fill out the registration form provided and send 
  54.     it to me. You will then receive instructions on how to remove the 
  55.     pester screen as well as the evaluation copy message.
  56.  
  57.     Program Startup:
  58.     ----------------
  59.     
  60.         The calling parameters for Hex Dump are:
  61.         
  62.              HEXD filename.ext [blocksize]
  63.         
  64.         FILENAME.EXT: is the filename and extension you wish to view.
  65.  
  66.         BLOCKSIZE:    is the optional blocksize to use. This can be any 
  67.                       value between 16 and 32767 bytes. The program 
  68.                       defaults to 256 bytes per block.
  69.     
  70.  
  71.     Using HEXD:
  72.     -----------
  73.     
  74.         Once the program begins you will see the following screen:
  75.  
  76. ╔═════════════════════════>!!EVALUATION COPY!!<════════════════════════════════╗
  77. ║ Address :   0 1  2 3  4 5  6 7  8 9  A B  C D  E F     0123456789ABCDEF      ║
  78. ╠══════════╪════════════════════╪═══════════════════╪══════════════════════════╣
  79. ║ 00000000:  0001 0203 0405 0607 0809 0a0b 0c0d 0e0f    |................|     ║
  80. ║ 00000010:  1011 1213 1415 1617 1819 1a1b 1c1d 1e1f    |................|     ║
  81. ║ 00000020:  2021 2223 2425 2627 2829 2a2b 2c2d 2e2f    | !"#$%&'()*+,-./|     ║
  82. ║ 00000030:  3031 3233 3435 3637 3839 3a3b 3c3d 3e3f    |0123456789:;<=>?|     ║
  83. ║ 00000000:  4041 4243 4445 4647 4849 4a4b 4c4d 4e4f    |@ABCDEFGHIJKLMNO|     ║
  84. ║ 00000000:  5051 5253 5455 5657 5859 5a5b 5c5d 5e5f    |PQRSTUVWXYZ[\]^_|     ║
  85. ║ 00000000:  6061 6263 6465 6667 6869 6a6b 6c6d 6e6f    |`abcdefghijklmno|     ║
  86. ║ 00000000:  7071 7273 7475 7677 7879 7a7b 7c7d 7e7f    |pqrstuvwxyz{|}~.|     ║
  87. ║ 00000000:  8081 8283 8485 8687 8889 8a8b 8c8d 8e8f    |ÇüéâäàåçêëèïîìÄÅ|     ║
  88. ║ 00000000:  9091 9293 9495 9697 9899 9a9b 9c9d 9e9f    |ÉæÆôöòûùÿÖÜ¢£¥₧ƒ|     ║
  89. ║ 00000000:  a0a1 a2a3 a4a5 a6a7 a8a9 aaab acad aeaf    |áíóúñѪº¿⌐¬½¼¡«»|     ║
  90. ║ 00000000:  b0b1 b2b3 b4b5 b6b7 b8b9 babb bcbd bebf    |░▒▓│┤╡╢╖╕╣║╗╝╜╛┐|     ║
  91. ║ 00000000:  c0c1 c2c3 c4c5 c6c7 c8c9 cacb cccd cedf    |└┴┬├─┼╞╟╚╔╩╦╠═╬╧|     ║
  92. ║ 00000000:  d0d1 d2d3 d4d5 d6d7 d8d9 dadb dcdd decf    |╨╤╥╙╘╒╓╫╪┘┌█▄▌▐▀|     ║
  93. ║ 00000000:  e0e1 e2e3 e4e5 e6e7 e8e9 eaeb eced eeef    |αßΓπΣσµτΦΘΩδ∞φε∩|     ║
  94. ║ 00000000:  f0f1 f2f3 f4f5 f6f7 f8f9 fafb fcfd feff    |≡±≥≤⌠⌡÷≈°∙·√ⁿ²■ |     ║
  95. ║                                                                              ║
  96. ║ 00000100:  0001 0203 0405 0607 0809 0a0b 0c0d 0e0f    |................|     ║
  97. ║ 00000110:  1011 1213 1415 1617 1819 1a1b 1c1d 1e1f    |................|     ║
  98. ╠══════════════════════════════════════════════════════════════════════════════╣
  99. ║ File Size:11ea1     Blk Size:100       # Blks:11e       Current Blk:0        ║
  100. ║  F1:Help  F2:Info  F3:File  F4:Search  F5:Defaults  F7:Print  F10/ESC: Quit  ║
  101.  
  102.  
  103.     The first thing you need to know is that the Hex Dump program 
  104.     works only with hex values both for displaying the data and for 
  105.     giving it the input information. The only exception to this is 
  106.     the block size given on the command link which is in decimal.
  107.     
  108.     The top line of the display gives the low nibble address of the 
  109.     data for both the hex and the ASCII display.
  110.     
  111.     Each of the data lines starts with the full starting address of 
  112.     that line followed by 16 bytes displayed in hex and then the same 
  113.     16 bytes of information displayed in ASCII. 
  114.     
  115.     A blank line separates blocks.
  116.  
  117.     The line second from the bottom give you information about the 
  118.     file size, block size, number of blocks in the file and your 
  119.     current location.
  120.     
  121.     The bottom line gives you reference as to the assignments of the 
  122.     function keys.
  123.     
  124.     To scroll the data either the up arrow or down arrow keys can be 
  125.     used as well as the page up and page down keys.
  126.  
  127.   F1 Key:
  128.   -------
  129.   
  130.     The F1 key displays the following help screen which gives more 
  131.     information on the function of each control key.  
  132.  
  133.  HEX DUMP HELP   (C) Copyright 1987-1991 Mike Fleischmann All rights reserved.  
  134. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  135. ░  Function Keys                           ░ Function Keys                     ░
  136. ░  F1 : This Help Screen                   ░ F7 : Printer Functions            ░
  137. ░  F2 : General File Information           ░      B: Print a Range of Blocks   ░
  138. ░  F3 : Used to change current file        ░      A: Print an Address Range    ░
  139. ░  F4 : Goto/Search Commands.              ░ F8 : RESERVED                     ░
  140. ░       G:Goto Block (+,- Relative blk)    ░ F9 : RESERVED                     ░
  141. ░       H:Do hex search  A:Do Ascii Srch   ░ F10: Exit Hex Dump                ░
  142. ░       C:Continue Search                  ░ ESC: Exit Hex Dump                ░
  143. ░  F5 : Set/Load/Use Translation tables.   ░                                   ░
  144. ░       A: Set Ascii translation table.    ░                                   ░
  145. ░       H: Set Hex translation table.      ░   Cursor Keys                     ░
  146. ░       L: Load translation buffer         ░   Uparrow  Scroll Data Up         ░
  147. ░       B: Set block Size                  ░   Dwarrow  Scroll Data Down       ░
  148. ░  F6:  Change Color Setup                 ░ PgUp Move Data Up One Page        ░
  149. ░                                          ░ PgDn Move Data Down One Page      ░
  150. ░                                          ░                                   ░
  151. ░                                          ░                                   ░
  152. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  153. ░  Calling Parameters  HEXD DRIVE:PATHNAME\FILENAME [block size]               ░
  154. ░  min block size=16  max block size=32767                                     ░
  155. ░                                                                              ░
  156. ░                                                              Press any key...░
  157. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  158.  
  159.   F2 Key:
  160.   -------
  161.  
  162.     Pressing the F2 key will display the following screen.
  163.     
  164. ********************************************************************************
  165.  
  166.                           HEX DUMP PROGRAM VERSION 1.41                     
  167.                                                                                 
  168.                                                                                 
  169.   Filename: test.dta
  170.                                                                                 
  171.   Filesize:    11ea1H bytes        11eH blocks                                  
  172.                                                                                 
  173.   Block Size:      100H bytes                                                   
  174.                                                                                 
  175.                                                                                 
  176.                         1 2 3 4 5                          N 1 2 3 4 5          
  177.   Ascii Tables Loaded:  _ * _ _ _    Current Table Active  _ _ * _ _ _          
  178.   Hex Tables Loaded:    _ _ _ _ _    Current Table Active  * _ _ _ _ _          
  179.                                                                                 
  180.                                                                                 
  181.               Hex Table                             Ascii Table                 
  182. ________________________________________________________________________________
  183.                                                                                 
  184.   Filename 1:                           Filename 1:                             
  185.   Filename 2:                           Filename 2: EBC2AS.TBL                            
  186.   Filename 3:                           Filename 3:                             
  187.   Filename 4:                           Filename 4:                        
  188.   Filename 5:                           Filename 5:                             
  189.                                                                                 
  190.                                                           Press any key...      
  191. ********************************************************************************
  192.  
  193.     Filename, Filesize, ect are pretty self explanatory however, you 
  194.     will notice that after that are several tables. The first table is 
  195.     the tables you have currently loaded into Hex Dump. You can load 
  196.     up to 5 conversion tables for either the ASCII portion of the 
  197.     display or the Hex portion. In the example above, ASCII table 
  198.     position has been loaded with the file EBC2AS.TBL and it is 
  199.     currently being used for display. In the second table a star in 
  200.     the 'N' position informs you that there is no table translation 
  201.     occuring for that display area.
  202.     
  203.     Each of these tables is a 256 byte direct look up table. I.E. if 
  204.     the value of the byte in the data file is 1F the program will go 
  205.     to the table at position 1F and substitute the value located there 
  206.     for the display.
  207.  
  208.     F3 Key:
  209.     -------
  210.     
  211.         The F3 key is used to change the file name you wish to view. 
  212.         When you press the F3 key a line will come up with the current 
  213.         file name in it. You may change this to the desired file name 
  214.         and then press ENTER to accept. Pressing ESC will abort the 
  215.         command and return you to the display screen. If you name a 
  216.         non-existent file the program will revert back to the previous 
  217.         file.
  218.         
  219.     F4 Key:
  220.     -------
  221.     
  222.         The F4 key initiates/continues the searching ability of the Hex 
  223.         Dump program. It also gives you the ability to goto any block 
  224.         in the file.
  225.         
  226.         Upon pressing F4, you will be asked if you want to do a (H)ex 
  227.         search,(A)scii search,(C)ontinue a previous search, or (G)oto 
  228.         an absolute block. Pressing the letter given in the parens 
  229.         will tell the program which choice you want. As with all the 
  230.         other functions, pressing ESC at any time will abort the 
  231.         process.
  232.         
  233.             (A) This will start an ASCII search. An input box will 
  234.                 come up and prompt you for the input you wish. The search 
  235.                 is case sensitive and special characters can be included.
  236.                 
  237.             (H) This will start the Hex search. An input box will come 
  238.                 up and prompt you for the hexadecimal values to search 
  239.                 on .
  240.                 
  241.             (C) This is used to continue searching from the point 
  242.                 where the previous search found the values you were 
  243.                 searching on.
  244.                 
  245.             (G) This will allow you to go to a specified block. Please 
  246.                 remember that the block number you input is in HEX. If 
  247.                 you enter a '+' or a '-' in front of the number the 
  248.                 program will move that many blocks relative to your 
  249.                 current position.
  250.  
  251.     F5 Key:
  252.     -------
  253.     
  254.         The F5 key is used to used/load the translation tables as well 
  255.         as change the default block size the program will use.  
  256.         
  257.         When you press the F5 key, you will be asked if you want to set 
  258.         the (A)scii translation to be used, the (H)ex translation 
  259.         table to be used, (L)oad a translation table into either the 
  260.         hex or ascii buffers, or changed the default (B)lock size.
  261.         
  262.             (A) This will bring up a question asking you for the table 
  263.                 number to use for the ASCII translation. You then 
  264.                 press 1 to 5 for tables 1 to 5 or pressing 'N' to 
  265.                 inform the program not to translate.
  266.                 
  267.             (H) This works just like the (A) above but affects the Hex 
  268.                 display part of the screen.
  269.                 
  270.             (L) Pressing this key will bring up another prompt asking 
  271.                 you if you want to load a (H)ex or (A)scii buffer. 
  272.                 Once you press the letter specifying you choice, the 
  273.                 program will ask you which buffer number you wish to 
  274.                 load. You then press a number between 1 and 5. At this 
  275.                 point the program will bring up all files in the local 
  276.                 directory that have the .TBL extension. You can simply 
  277.                 highlight the one you want or press ? to enter a file 
  278.                 name. Please note that this assumes that the 
  279.                 translation files will be in the local subdirectory 
  280.                 and have the extension .TBL. Also the program will 
  281.                 only use the first 256 bytes of the file or the length 
  282.                 of the file, which ever is smaller.
  283.            
  284.             (B) Pressing this key will bring up a prompt asking you 
  285.                 for the new block size to use as the default. Enter in 
  286.                 a number between 10H to 7FFFH.
  287.  
  288.     F6 Key:
  289.     -------
  290.         
  291.         Pressing the F6 key will activate the color change screen. 
  292.         (shown below)
  293.         
  294. ┌─────────────────────────> HEXD COLOR CHANGE SCREEN <─────────────────────────┐
  295. │                                                                              │
  296. │               This is the color for NORMAL text                              │
  297. │               This is the color for INTENSE text                             │
  298. │               This is the color for HIGHLIGHTed text                         │
  299. │               This is the color of the text used for ERRORS                  │
  300. │               This is the color of the text used for MESSAGES                │
  301. │               This is the Color of the text used for TITLES                  │
  302. │                                                                              │
  303. ├──────────────────────────────────────────────────────────────────────────────┤
  304. │                                                                              │
  305. │ Use the function keys to change the color scheme to your liking. To make     │
  306. │ the changes permanent press ALT-F1. Please note that you must be in the      │
  307. │ subdirectory where HEXD.EXE resides for the changes to be made.              │
  308. │                                                                              │
  309. ├──────────────────────────────────────────────────────────────────────────────┤
  310. │                                                                              │
  311. │ F1: Increase normal text color        F2: Decrease normal text color         │
  312. │ F3: Increase intense text color       F4: Decrease intense text color        │
  313. │ F5: Increase highlight text color     F6: Decrease highlight text color      │
  314. │ F7: Increase error text color         F8: Decrease error text color          │
  315. │ F9: Increase message text color       F10: Decrease message text color       │
  316. │ Shift F1: Increase title text color   Shift F2: Decrease title text color    │
  317. │                                                                              │
  318. └──────────────────────────────────────────────────────────────────────────────┘
  319.   
  320.     Just follow the instructions to change the colors you want. 
  321.     Pressing ESC will return you to the main screen so you may review 
  322.     the color choices. ALT-F1 will make the changes permanent if you 
  323.     are in the same directory where the HEXD.EXE program resides.  
  324.  
  325.     F7 Key:
  326.     -------
  327.     
  328.         Pressing the F7 key will invoke the print function of Hex 
  329.         Dump. When you press F7 the program will ask you if you want 
  330.         to print (B)locks or an (A)ddress range. After you make your 
  331.         selection, the program will ask you for the start and end 
  332.         blocks/addresses. The program only prints to LPT1: so if you 
  333.         use a COM port for your printer you will need to use the mode 
  334.         command to redirect it. During printing you may now cancel the 
  335.         print job by pressing ESC.
  336.         
  337.     F10/ESC Key:
  338.     ------------
  339.     
  340.         Pressing the F10 or the ESC key from the main screen will exit 
  341.         the program. You will be prompted to verify the exit by 
  342.         pressing 'Y'. Then the program will exit. If you are running 
  343.         an evaluation copy you will have a 10 second delay with a 
  344.         please register screen before the program exits.
  345.  
  346.  
  347.     History:
  348.     --------
  349.         Changes 1.40 to 1.41:
  350.         ---------------------
  351.             
  352.             o  Added color to the screen and ability of user to change 
  353.                the color and make it permanent.
  354.                
  355.             o  Added a relative goto block function. This allows the 
  356.                user to go so many blocks forward/backward from the 
  357.                current position.
  358.             
  359.             o  Added the ability to abort a print job by pressing ESC.
  360.             
  361.             o  When in the file load screen pressing ESC will now 
  362.                leave you at your previous position in the file.
  363.                
  364.             o  End of file display is now cleaner.
  365.             
  366.         Version 1.40: (this was the first version release to shareware.)
  367.         ----------------------------------------------------------------
  368.         I work as a systems analyst. One contract dealt with large 
  369.         files that were in EBCDIC. I wrote HEXD in 1987 to allow me to 
  370.         do the analysis I needed to fulfil the contract. I also gave 
  371.         the company I was contracting with a site license. I am 
  372.         amazed that over the years I have yet to encounter a program 
  373.         that fills the niche this one does and that I have needed to do 
  374.         very little in the way of revisions. After some thought I 
  375.         decided to offer this program as shareware to help others with 
  376.         their data analysis problems.
  377.         
  378.         I want HEXD to evolve. I am open to comments and suggestions 
  379.         on ways to improve it. Because of the small price I am 
  380.         asking for the program, I will only respond to problems from 
  381.         registered users. If you are the first registered user to 
  382.         identify a bug in the program, I will mail you a new copy as 
  383.         soon as the problem is corrected. Comments and suggestions are 
  384.         most welcome. 
  385.         
  386.         If you offer a unique suggestion that I implement in HEXD I 
  387.         will send you a registered version as soon as I implement 
  388.         your comment. I will send you a registered version even if 
  389.         you were not previously registered. (private parties only 
  390.         please!!)
  391.  
  392.         You can send comments/suggestions/problems to the address 
  393.         given on the title page. Or if you use EXEC PC, I can be 
  394.         reached there under my name.
  395.         
  396.         The number of registrations will determine how fast this 
  397.         product evolves. Some ideas I have are:
  398.         
  399.             o   Add user defined colors. (DONE in 1.41)
  400.             o   Allow the program to write to files
  401.             o   Support searching through the translation tables
  402.                 (currently searching is independent of the tables)
  403.             o   Build in one or more of the most used tables.
  404.             o   Wild card searching.
  405.             o   Print to files as well as the printer.
  406.             o   Allow the user to save off pieces of the current file.
  407.  
  408.     Now for all the legal stuff:
  409.  
  410.     ***************************************************************
  411.     *       Hex Dump is Copyright 1987-1991 by Mike Fleischmann.  *
  412.     *       All rights reserved.                                  *
  413.     ***************************************************************
  414.  
  415.          *  A $15 shareware contribution is  requested  for  using  the
  416.             program.
  417.          *  The author retains the sole right to sell the program.
  418.          *  The author grants users the right to  copy  and  distribute
  419.             the program within the following constraints:
  420.               - All program files remain unaltered and are  distributed
  421.                 en masse.
  422.               - Only the original "non-cloned" version of  the  program
  423.                 with the  startup/termination  and  drive  change  time
  424.                 delays is distributed.
  425.               - No attempt is made to sell  the  program,  or  to  make
  426.                 money from it or any modified version of it.
  427.               - The program is not bundled with any other  hardware  or
  428.                 software transactions without the author's  permission.
  429.               - Recognized  users'  groups  may  charge  a  maximum  $5
  430.                 duplication or distribution fee.
  431.          *  Continued use of the program (more  than 1 month)  by  any
  432.             individual, corporation or  institution  without  a  single
  433.             user or site license is prohibited.
  434.          *  Single user licenses are obtained by  sending  in  the  $15
  435.             shareware contribution.
  436.          *  Corporations and other institutions  (including  government
  437.             and educational)  which desire  using  the  program  should
  438.             refer  to  the   "HD_SITE.LIC"  file   for  site  licensing
  439.             information.
  440.  
  441.     **********************************************************************
  442.     *                      Disclaimer and warranty                       *
  443.     **********************************************************************
  444.  
  445.                The author disclaims all warranties expressed or implied
  446.          as to the  quality or performance of this program.  The author
  447.          will not be held liable for any lost profits, lost savings  or
  448.          any  other  direct,  indirect,  incidental   or  consequential
  449.          damages resulting from the use of this program.  Your  use  of
  450.          this program constitutes your agreement to this disclaimer and
  451.          your  release of  the author from any  form  of  liability  or
  452.          litigation.
  453.